home *** CD-ROM | disk | FTP | other *** search
/ Scene Storm / Scene Storm - Volume 1.iso / coding / c / pdc / readme < prev    next >
Encoding:
Text File  |  1990-04-19  |  6.0 KB  |  132 lines
  1. README - Some remarks and words of advice on using PDC
  2. ------------------------------------------------------
  3.  
  4. The major pieces of this distribution are the compiler (PDC), the assembler
  5. (A68k), the linker (BLink), and the libraries and header files.  Tying
  6. everything together is a "front-end" program (CCX), which takes care of a
  7. lot of the drudgery behind creating an executable program.
  8.  
  9. Things to do before invoking CCX
  10. --------------------------------
  11.  
  12. CCX requires that the following environment variables be set:
  13.  
  14.         PDCLibs - Lists the libraries with which to link
  15.         PDCLibDirs - Lists the directories to search for libraries
  16.         PDCIncDirs - Lists the directories to search for include files
  17.  
  18. Multiple entries for an environment variable are delimited by
  19. semicolons.  See the file s/start on this disk and the documentation to
  20. CCX in the doc directory on this disk for examples of how to use the
  21. environment variables. 
  22.  
  23. As for your search path, at the very least you ought to have in it the
  24. directory containg CCX, PDC, A68k, and BLink.  This is necessary if you
  25. plan to use CCX. 
  26.  
  27. Stack size for running PDC should be above the CLI's default of 4K.
  28. 20000 bytes is the lowest recommended size.  32000 bytes is sufficient
  29. for most things, up to and including recompiling PDC and its libraries.
  30. To be safe, it is best to set a good large stack size in your startup-sequence,
  31. because forgetting later on usually results in a visit from the Guru.  Should
  32. PDC ever guru on you, the first step to take is bump up the stack.  
  33.   
  34. In summary:
  35.  
  36.         - Set the environment variables PDCLibs, PDCLibDirs, and PDCIncDirs.
  37.     - CCX requires that PDC, A68k, and Blink be in your search path.
  38.     - PDC needs a MINIMUM of 20K of stack space to run safely.
  39.  
  40.  
  41. Headers, Libraries, and Startup code
  42. ------------------------------------
  43.  
  44. Standard C headers can be found in the directory "include" on this disk.
  45. See below for more information on Amiga-specific headers.
  46.  
  47. The PDC Software Distribution includes the three library files necessary to
  48. compile programs written for the Amiga.  Here are some short descriptions of
  49. them:
  50.  
  51. * Amiga.lib
  52.  
  53.      Amiga.lib contains the hundereds of assembly language stubs, or
  54.      "stub-routines", that allow programs written in C to call the Amiga's
  55.      standard set of shared libraries.  It also contains a few functions to
  56.      aid in the construction and destruction of some common entities (eg,
  57.      CreateTask, DeletePort, NewList, etc.).  The version of Amiga.lib
  58.      included with PDC can be built automatically by invoking the makefile
  59.      contained in the "lib/src" directory on this disk and providing a copy
  60.      of your Workbench 1.3 Extras disk.  For convenience, a pre-made copy
  61.      of Amiga.lib is now included on this disk.
  62.  
  63. * PDC.lib:
  64.  
  65.      PDC.lib contains a large subset of the ANSI C functions, as well as some
  66.      runtime support functions and other extensions.  A (currently, partial)
  67.      list of the functions provided in PDC.lib and Math.lib can be found in
  68.      the file MANIFEST in the LibSrc directory on the Libs and Utils disk. 
  69.  
  70. * Math.lib:
  71.  
  72.      Math.lib contains library and runtime support functions for performing
  73.      floating point math.  Currently, PDC supports only IEEE double precision
  74.      math via the Amiga's shared libraries, ieeedoubbas.library and
  75.      ieeedoubtrans.library.  As you may realize, this default requires that
  76.      Workbench 1.3 be available at runtime in order use the transcendental
  77.      functions.  The source code for the transcendental functions is
  78.      provided, though, if you care to use it.
  79.  
  80. Most programs written specifically for the Amiga, including much source
  81. code to this distribution, require the Amiga header files in order to
  82. compile.  Those who also own one of the commercial C compilers can
  83. generally get away with using the headers that come with those compilers
  84. [1].  In any case, I recommend that you obtain the Native Developer
  85. Update (NDU) from Commodore-Amiga Technical Support (CATS).  The NDU
  86. includes commented and stripped versions of the Amiga C and assembly
  87. language headers, the fabled Autodocs, a healthy batch of README files,
  88. and Commodore's standard libraries and utilities.  Altogether, you get
  89. four disks for US$20; an excellent deal.
  90.  
  91. To receive your own copy of the Native Developer Update, send to the
  92. following address a check for $20 (US) made payable to Commodore
  93. Business Machines:
  94.  
  95.                 CATS - Orders
  96.                 1200 Wilson Drive
  97.                 West Chester, PA  19382
  98.  
  99.  
  100. [1]  However, beware of conflicts!  You should set up your PDCIncDirs
  101.      environment variable so that it reads the PDC headers first, lest
  102.      you wind up with the wrong version of stdio.h or some other such
  103.      problem.
  104.  
  105. Although the PDC Software Distribution is freely distributable, and we wish
  106. it to remain as much so as possible, there is a considerable amount of time
  107. involved in maintaining and improving the software and documentation.  If
  108. it proves financially feasible, Paul Petersen and I would like to continue
  109. improving PDC at a more rapid pace, and still maintain its status as a
  110. freely distributable package.  The bottom line is, your donation of $10, or
  111. whatever PDC is worth to you, is an excellent way to reward our work and
  112. encourage further development.  Furthermore, if you wish to receive the most
  113. current release of PDC directly from us, just send in a donation of $15 or 
  114. more and we'll mail out the three-disk set right away.  Please make all
  115. checks payable to Lionel D. Hummel.
  116.  
  117. If you have access to Usenet, you can participate in discussion on PDC by
  118. subscribing to the info-pdc mailing list.  You can do this by sending email
  119. to pdc-request@cs.uiuc.edu (uunet!uiucdcs!pdc-request).  Or, if you have
  120. something you wish to discuss with us directly, you can reach us by email:
  121.  
  122.     lionel%large.UUCP@cs.uiuc.edu         or, on BIX: lhummel
  123.     petersen@uicsrd.csrd.uiuc.edu
  124.  
  125.                 Enjoy,
  126.                 Lionel Hummel
  127.                 Paul Petersen
  128.  
  129.                                 PDC Software Distribution
  130.                                 P.O. Box 4006
  131.                                 Urbana, IL  61801-8801
  132.